﻿<html>
  <head>
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <meta name="Microsoft.Help.SelfBranded" content="true" />
    <meta name="Language" content="en-us" />
    <meta name="Microsoft.Help.Locale" content="en-us" />
    <meta name="Microsoft.Help.TopicLocale" content="en-us" />
    <link rel="shortcut icon" href="../icons/favicon.ico" />
    <link rel="stylesheet" type="text/css" href="../styles/branding.css" />
    <link rel="stylesheet" type="text/css" href="../styles/branding-en-US.css" />
    <script type="text/javascript" src="../scripts/branding.js"></script>
    <title>XmlHelp.CreateXElement Method</title>
    <meta name="Title" content="CreateXElement Method" />
    <meta name="Microsoft.Help.Id" content="M:SosoMS.Common.FileHelp.XmlHelp.CreateXElement(System.String,System.Collections.Generic.Dictionary{System.String,System.String})" />
    <meta name="Microsoft.Help.ContentType" content="Reference" />
    <meta name="System.Keywords" content="XmlHelp.CreateXElement method" />
    <meta name="System.Keywords" content="CreateXElement method" />
    <meta name="Microsoft.Help.F1" content="SosoMS.Common.FileHelp.XmlHelp.CreateXElement" />
    <meta name="Microsoft.Help.F1" content="XmlHelp.CreateXElement" />
    <meta name="Microsoft.Help.F1" content="CreateXElement" />
    <meta name="container" content="SosoMS.Common.FileHelp" />
    <meta name="file" content="ba0fc6ac-5f28-ea3d-6596-96aa0ecb47b3" />
    <meta name="guid" content="ba0fc6ac-5f28-ea3d-6596-96aa0ecb47b3" />
    <meta name="Microsoft.Help.Category" content="CSharp" />
    <meta name="Description" content="创建一个对象" />
    <link type="text/css" rel="stylesheet" href="../styles/highlight.css" />
    <script type="text/javascript" src="../scripts/highlight.js"> </script>
    <link rel="stylesheet" type="text/css" href="../styles/branding-Help1.css" />
  </head>
  <body onload="SetDefaultLanguage('cs');">
    <input type="hidden" id="userDataCache" class="userDataStyle" />
    <div id="PageHeader" class="pageHeader">嗖嗖常用方法帮助集</div>
    <div class="pageBody">
      <div id="TopicContent" class="topicContent">
        <table class="titleTable">
          <tr>
            <td class="titleColumn">
              <h1>Xml<wbr />Help<span id="LSTF497D90B_0" data-languageSpecificText="cpp=::|nu=."></span>Create<wbr />XElement Method</h1>
            </td>
          </tr>
        </table>
        <div class="summary">
            创建一个<a href="https://learn.microsoft.com/dotnet/api/system.xml.linq.xelement" target="_blank" rel="noopener noreferrer">XElement</a>对象
            </div>
        <br />
        <strong>Namespace:</strong> <a href="4f2fecb0-966c-232d-a819-c35018f8ad72.htm">SosoMS.Common.FileHelp</a><br /><strong>Assembly:</strong> SosoMS.Common (in SosoMS.Common.dll) Version: 1.0.0<div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('IDB')" onkeypress="SectionExpandCollapse_CheckKey('IDB', event)" tabindex="0"><img id="IDBToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />Syntax</span></div><div id="IDBSection" class="collapsibleSection"><div id="IDAB" class="codeSnippetContainer"><div class="codeSnippetContainerTabs"><div id="IDAB_tab1" class="codeSnippetContainerTab"><a href="#" onclick="ChangeTab('IDAB','cs','1','4');return false;">C#</a></div><div id="IDAB_tab2" class="codeSnippetContainerTab"><a href="#" onclick="ChangeTab('IDAB','vb','2','4');return false;">VB</a></div><div id="IDAB_tab3" class="codeSnippetContainerTab"><a href="#" onclick="ChangeTab('IDAB','cpp','3','4');return false;">C++</a></div><div id="IDAB_tab4" class="codeSnippetContainerTab"><a href="#" onclick="ChangeTab('IDAB','fs','4','4');return false;">F#</a></div></div><div class="codeSnippetContainerCodeContainer"><div class="codeSnippetToolBar"><div class="codeSnippetToolBarText"><a id="IDAB_copyCode" href="#" class="copyCodeSnippet" onclick="CopyToClipboard('IDAB');return false;" title="Copy">Copy</a></div></div><div id="IDAB_code_Div1" class="codeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="keyword">public</span> <span class="identifier">XElement</span> <span class="identifier">CreateXElement</span>(
	<span class="identifier">string</span> <span class="parameter">name</span>,
	<span class="identifier">Dictionary</span>&lt;<span class="identifier">string</span>, <span class="identifier">string</span>&gt;? <span class="parameter">attributes</span> = <span class="keyword">null</span>
)</pre></div><div id="IDAB_code_Div2" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">Public</span> <span class="keyword">Function</span> <span class="identifier">CreateXElement</span> ( 
	<span class="parameter">name</span> <span class="keyword">As</span> <span class="identifier">String</span>,
	Optional <span class="parameter">attributes</span> <span class="keyword">As</span> <span class="identifier">Dictionary</span>(<span class="keyword">Of</span> <span class="identifier">String</span>, <span class="identifier">String</span>) = <span class="keyword">Nothing</span>
) <span class="keyword">As</span> <span class="identifier">XElement</span></pre></div><div id="IDAB_code_Div3" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">public</span>:
<span class="identifier">XElement</span>^ <span class="identifier">CreateXElement</span>(
	<span class="identifier">String</span>^ <span class="parameter">name</span>, 
	<span class="identifier">Dictionary</span>&lt;<span class="identifier">String</span>^, <span class="identifier">String</span>^&gt;^ <span class="parameter">attributes</span> = <span class="keyword">nullptr</span>
)</pre></div><div id="IDAB_code_Div4" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">member</span> <span class="identifier">CreateXElement</span> : 
        <span class="parameter">name</span> : <span class="identifier">string</span> * 
        ?<span class="parameter">attributes</span> : <span class="identifier">Dictionary</span>&lt;<span class="identifier">string</span>, <span class="identifier">string</span>&gt; 
(* Defaults:
        <span class="keyword">let </span><span class="identifier">_</span><span class="identifier">attributes</span> = defaultArg <span class="identifier">attributes</span> <span class="keyword">null</span>
*)
<span class="keyword">-&gt;</span> <span class="identifier">XElement</span> </pre></div></div></div><h4>Parameters</h4><dl><dt class="has-text-weight-normal"><span class="parameter">name</span>  <a href="https://learn.microsoft.com/dotnet/api/system.string" target="_blank" rel="noopener noreferrer">String</a></dt><dd>XElement名称</dd><dt class="has-text-weight-normal"><span class="parameter">attributes</span>  <a href="https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary-2" target="_blank" rel="noopener noreferrer">Dictionary</a><span id="LSTF497D90B_1" data-languageSpecificText="cpp=&lt;|cs=&lt;|fs=&lt;|vb=(Of |nu=("></span><a href="https://learn.microsoft.com/dotnet/api/system.string" target="_blank" rel="noopener noreferrer">String</a>, <a href="https://learn.microsoft.com/dotnet/api/system.string" target="_blank" rel="noopener noreferrer">String</a><span id="LSTF497D90B_2" data-languageSpecificText="cpp=&gt;|cs=&gt;|fs=&gt;|vb=)|nu=)"></span>  (Optional)</dt><dd>特性字典</dd></dl><h4>Return Value</h4><a href="https://learn.microsoft.com/dotnet/api/system.xml.linq.xelement" target="_blank" rel="noopener noreferrer">XElement</a><br /><a href="https://learn.microsoft.com/dotnet/api/system.xml.linq.xelement" target="_blank" rel="noopener noreferrer">XElement</a>对象</div><div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('IDFC')" onkeypress="SectionExpandCollapse_CheckKey('IDFC', event)" tabindex="0"><img id="IDFCToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />Exceptions</span></div><div id="IDFCSection" class="collapsibleSection"><table><tr><th>Exception</th><th>Condition</th></tr><tr><td><a href="https://learn.microsoft.com/dotnet/api/system.argumentnullexception" target="_blank" rel="noopener noreferrer">ArgumentNullException</a></td><td /></tr></table></div><div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('IDBC')" onkeypress="SectionExpandCollapse_CheckKey('IDBC', event)" tabindex="0"><img id="IDBCToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />Remarks</span></div><div id="IDBCSection" class="collapsibleSection">
            使用指定的节点名，创建一个<a href="https://learn.microsoft.com/dotnet/api/system.xml.linq.xelement" target="_blank" rel="noopener noreferrer">XElement</a>对象，如果指定了attributes字典对象<br />则添加相应的特性到节点中。<br />
            如果节点名称传入空白或者为空，则抛出一个<a href="https://learn.microsoft.com/dotnet/api/system.argumentnullexception" target="_blank" rel="noopener noreferrer">ArgumentNullException</a></div><div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('IDCC')" onkeypress="SectionExpandCollapse_CheckKey('IDCC', event)" tabindex="0"><img id="IDCCToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />Example</span></div><div id="IDCCSection" class="collapsibleSection">
            创建一个没有特性的节点
            <div id="IDBCC" class="codeSnippetContainer"><div class="codeSnippetContainerTabs"><div id="IDBCC_tab1" class="codeSnippetContainerTabSingle">C#</div></div><div class="codeSnippetContainerCodeContainer"><div class="codeSnippetToolBar"><div class="codeSnippetToolBarText"><a id="IDBCC_copyCode" href="#" class="copyCodeSnippet" onclick="CopyToClipboard('IDBCC');return false;" title="Copy">Copy</a></div></div><div id="IDBCC_code_Div1" class="codeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="highlight-keyword">var</span> xmlHelp = <span class="highlight-keyword">new</span> XmlHelp(fileName);
<span class="highlight-keyword">var</span> xElementRoot = xmlHelp.GetXElements(<span class="highlight-literal">"root"</span>, <span class="highlight-keyword">false</span>).First();
<span class="highlight-keyword">var</span> xElementChild = xmlHelp.CreateXElement(<span class="highlight-literal">"Data"</span>, <span class="highlight-keyword">null</span>);
xElementRoot.Add(xElementChild);
xmlHelp.Save();</pre></div></div></div>
            创建一个有特性的节点
            <div id="IDDCC" class="codeSnippetContainer"><div class="codeSnippetContainerTabs"><div id="IDDCC_tab1" class="codeSnippetContainerTabSingle">C#</div></div><div class="codeSnippetContainerCodeContainer"><div class="codeSnippetToolBar"><div class="codeSnippetToolBarText"><a id="IDDCC_copyCode" href="#" class="copyCodeSnippet" onclick="CopyToClipboard('IDDCC');return false;" title="Copy">Copy</a></div></div><div id="IDDCC_code_Div1" class="codeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="highlight-keyword">var</span> xmlHelp = <span class="highlight-keyword">new</span> XmlHelp(fileName);
<span class="highlight-keyword">var</span> xElementRoot = xmlHelp.GetXElements(<span class="highlight-literal">"root"</span>, <span class="highlight-keyword">false</span>).First();
<span class="highlight-keyword">var</span> xElementChild = xmlHelp.CreateXElement(<span class="highlight-literal">"Data"</span>, <span class="highlight-keyword">new</span> Dictionary&lt;<span class="highlight-keyword">string</span>, <span class="highlight-keyword">string</span>&gt; { { <span class="highlight-literal">"First"</span>, <span class="highlight-literal">"one"</span> }, { <span class="highlight-literal">"Second"</span>, <span class="highlight-literal">"two"</span> } });
xElementRoot.Add(xElementChild);
xmlHelp.Save();</pre></div></div></div></div><div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('seeAlso')" onkeypress="SectionExpandCollapse_CheckKey('seeAlso', event)" tabindex="0"><img id="seeAlsoToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />See Also</span></div><div id="seeAlsoSection" class="collapsibleSection"><h4>Reference</h4><div><a href="931ae64d-1ef1-7c01-4eb4-cf2b5fc39cde.htm">XmlHelp Class</a></div><div><a href="4f2fecb0-966c-232d-a819-c35018f8ad72.htm">SosoMS.Common.FileHelp Namespace</a></div><div><a href="https://learn.microsoft.com/dotnet/api/system.xml.linq.xelement.setattributevalue#system-xml-linq-xelement-setattributevalue(system-xml-linq-xname-system-object)" target="_blank" rel="noopener noreferrer">SetAttributeValue(XName, Object)</a></div></div></div>
    </div>
    <div id="PageFooter" class="pageFooter" />
  </body>
</html>